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DISCLAIMER’) 


This program and its documentation have-been contributed to the Program 
Information Department by an IBM emplovee and are vrovided by the IBM 
Corporation as part of its service to customers. The program and its 
documentation are essentially in the author's oriqinal form and have not 
heen subjected to any formal testing. IBM makes no warranty expressed 
or implied as to the documentation, function, or performance of this 
program and the user of the program is expected to make the final 
evaluation as to the usefulness of the program. in his own environment. 
Tnere is no committed maintenance for the prodea 

Questions concerning the use of the program should be directed to the 
or or other designated party. Any changes ae the program will be 
ammounced in the appropriate Catalog of Programs; however, the changes — 
will not be distributed automatic see to users "When such an announce-= 
ment occurs, users should order only the material (documentation, machine 
readable or both) as indicated in the appropriate Catalog of Progwans. 
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streams for one or two DOS batch page one. 
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Machine Configuration: anythardware which will support DOS; practically, however, 
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DOS AUTOMATIC SPOOLING SYSTEM 
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: ‘Geieral Overview of Spool * A S258 


A DOS input reader is defined as a program to read cards onto a 


disk for eventual use for execution of the batch partition{s}), Such 


’ ° 


‘a program, operating in the spool partition, progresses asynchronously 


- “to the execution of the batch partition(s), and to the executicn of any 


S | 
other reader or writer within the spool partition. 
‘ee ee | 
| A DOS suena writer is defined as a program toprintor punch records 
which have been previously created by the batch partition{s}. Such a 
program, operating in the spool partition, progresses asynchronously to 
the execution of any other writer = reader within the spool partition. 
An execution processor is defined’ as a program, operating in the spool 
| partition, to accomplish tke following: 
ee a. Read blocked card images from a disk which have beén : 
placed on a disk by a reader. 
b. Supply the card images to the batch program whenever 
the batch program requests . read a card record ftom 
SYSIN; } 
: c. Save the print/punch images whenever the batch program | 
requests to write a line/card. 
. 


d. .Write blocked print/punch disk records for later use by 


Pas é 
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an outputl writer. 2 
> ; as d 
o 
i 8 # 
I ae y 
\erecegy eet 3 er 


e 


= , . cae 


af 


DOS reader/writer capability is designed for, and justified 


s') 


through, the following facilities and features: 


Significantly increase batch processing throughput 
Reduction of scheduling bottlenecks : 
More flexibility in job scheduling . a. 
Can be implemented without any IBM program or 
' 
user program modification io Weed 
Recovery capability (warm start) | | : we 
a 
Can optionally support one or two DOS batch partitions , ! 
. Can selectively use tape for intermediate storage of 
print/punch information ; 
Can support multiple 2311/2314 (no mix) - os en 
os % ; : : 
Can support simiuitaneous uhit record spool functions ; 
126 maximum readers and writers) ‘ 
é . ¢ 
Cptional writer only capability (reduces core requirements) 
Potential future support for Type 50 magnetic inscriber . 
and remote job entry 
User may include his own job accounting routines 
han : oe aa = 
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Secx Mea fe e | : dag ‘ F 1) A program requires a special printer carriage control 
Following is a discussion on the implementation considerations : | 


; : ‘ tape and the program tests for the channel 9 or channel 
which must be reviewed in order to evaluate the spool system: oars 


12 condition. 


a. The spool program must exclusively occupy a foreground . 
wis | oo : —— 2) ' A program specifically tests for the channel 9 ccndition. 
partition, In a non-teleprocessing environment, as many as j . 
ve : 3) A program skips to channel 9 or 12. 
two batch partitions could be supported by the foreground 
spool program, In a BTAM TP environment, one batch | 
| | da. Disk storage capacity is utilized in the following files: 


partition could be supported. With some programming os 


1. QFILE - This file is used to store the status ofa _ 
effort, a BTAM TP program could operate as a spool aaa , 


ea ot job during its life within the spool system, One 
task within the spool partition. | eens 


disk block (i.e. 260 bytes) is used for each job. 
b. Batch program I/O references to SYSRDR, SYSIPT, | . 


Hence, for.a 2311 system which has allocated 1 
‘SYSLST, and SYSPCH are dynamically trapped and 


: cylinder for this file, 110 jobs may be active within 
spooled only when the system symbolic units are 


a gah + Meta the system (260 byte blocks =11 blocks = 10x11 
assigned to unit record type devices, i.e., if SYSRDR ' 


‘ : : ; : 1% = 110 blocks per cylinder) 
is assigned to a card reader while SYSIPT is assigned 7 


, 2. DATAFIL- This file is used to store card images 
to tape, then reader spool functions are only supported _ , aE a Oe 


for the reader and is used to store print images 


» 


for the SYSRDR symbolic unit. Any batch program 


and/or card images for the output writers. One disk 
requests for SYSIPT are normally serviced by the DOS : 


, ‘block (i.e. 829 bytes) can hold 9 card images for the 
supervisor. | 


| : readers, The same size block can hold a variable number 
c. | Automatic channel 12 line counting is supported for an — | 


of print images or punch card images according to the 
"all channel" printer carriage control tape. If no 


: : , ; : : '. following rule: 
programs in the installation require special printer | 
6 bytes overhead/block = 
carriage control tapes, then the automatic line counting ; 7 
' ' 2 bytes overhead/logical record 
facility within spool will adequately handle ail programs. 


; n bytes per logical record where all 
However, line counting within the spool system or within 


blanks to the right of the last significant 
the users programs must be added tc handle the following . ; 


6 e ° : en et 


three situations: 3. SE ne aa etn 


. . ee ee Ie 
. ° 
. . o é . . 7 
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® non blank character have been removed ge © 4 | | | ; * . 
| , | | 4 


forthe DATAFIL, The following three sample spool 


Incidentally, the above tule also applies to the tape block layout, 


if tape intermediate storage is used by the output writers. Sire systems should meester you mae understanding how men 


the space on the DATAFIL is dynamically reserved and released, puiters:enould, Re eloceted te tee ek ea 


estimating how many cylinders should be dedicated to the file is 4. | a 1) One batch with continuously active reader, print 


job stream dependent. Any job stream, operating with a small ee and punch writer - each reader/writer was 


 DATAFIL, which generates a tremendous amount of printing and/or stented wits ene pu option. Hence, each 


punching may have to selectively use tape for intermediate spool data Seamer WaNGr Vacs s pullers), 2 for 1/0 and | for 


; i T i ; 
storage, Since spool's accessing of the DATAFIL can be numerous, ot ce eG earor has 2 disk 1/O buffers 


the sharing of a single disk volume with multiple user files and the ; each for reading, printing, and punch pseudo functions | 


DATAFIL should be kept to an absolute minimum, otherwise, per- - eS . for a total of 6, Thus, be bem byte putters would pe 


formance may drastically suffer. . used for this system. ‘Total core; 


8K core resident 
e. Spool eGre storage is allocated in the following manner: — 7 | ca74 | : 12K 15 @~800 buffers 
i. ' Core resident spool code - This portion of the spool system | s _ os 20K | 
| occupies approximately 8192, byte plus and as many as | | 
1000 bytes depending aaa the sean sysgen parameters. oo 2) | One batch with a continuously ache printer writer, 


ot . | . - a continuously active reader or a punch writer - each 


» 


ii, Buffer pool - This area setves three functions: ,. 18 | - -. . _ printer writer started with 2 buffers; reader oF punch 
1) ai Oareal Se: Pe = a a ee | | oo , ‘writer started with 1 buffer; total = 6 buffers. Batch 
2) °° tape 1/0 pea. ieecks. | tee = oe : S ; . | es . execution has 1 disk buffer ee reading feacties and 
3) -“- when active, reader or writer program storage © 2 . | 3 disk buffers shared between printing and punching funce 
ete t Peden, <x 8 eh 8 ies * a, | . 7 tions - total core: | 
The size of each buffer is determined at spool sysgen ~  °- - a | ve | 8K | resident | 2 
' time by declaring the size of ‘Ke disk blocks (DB LK) a ee | fie ee aK 10 @ ~800 


7. : | | 8. 
me ee : oa . 16K 


wt 


en a 


3) One batch with no reader, and with a continuously active 
printer writer or punch writer - Each printer writer or punch writer 


1 ‘ 


started with 2 ‘disk buffers. Batch execution has 1 disk buffer 


for print and 1 disk buffer for punch functions. Total core: 


. BK resident 

4K + (58 @R800 CO” , 
caret! carer ee? i 

2K 


The DOS supervisor must be generated with the MPS and the TP option. 
Obviously, the resultant core size of the DOS supervisor should be in- 


Batch program I/O references to problem ‘program symbolic Maite (axe 


vestigated. 


handled in the same manner as those I/O references to the Bystc ms 


. symbolic units. See part b. of this section for further discussion. 


"2, 'Deblock the PID tape- 


a Spool Systems Generation Procedures 


1, Review the DOS supervisor generation parameters which were used to create | 


the current operational control program, If the SUPVR macro was coded with 


either the MPS=NO ‘or the TP=NOQO, then you must reassemble the supervisor 


/ 


: with both of these parameters included. MPS=YES and TP=BTAM would 
generate the least amount of additional core within the, control program, 


However, you may use any entry value for the two macro parameters. In 


° ¢ 


addition the CCHAIN=YES must be declared in the FOPT macro. 


Original blocking: _ 81 byte records - blocked 40 


81 byte records - unblocked ; 


The standard DOS tape to tape utility can be used to accomplish the deblocking 


Resultant blocking: 


with the following control cards: 
E // JOB DEBLOCK SPOOL TAPE |. 
// ASSGN SYS004, x'cuu! PID TAPE a 
// ASSGN SYS6055x°’ cuu! UNLABLED DEBLOCKED TAPE 
// UPSI 16101000 | 
‘// EXEC TPTP | 
{7 UTT TR,FF,A=(81, 3240),B=(81,81),IR,R1,OR 7 
// END | bn. Thee ee 
{& “64 : , eo ort ne 
3. Execute the following jab stream assigning the deblocked tape to SYSIPT: 
/{ JOB CATALOG MAGROS - , 


DEBLOCKED TAPE 
10. | 


/} ASSGN SYSIPT, x'cuu! 


{ 


“ 


a J ‘ 
© . Note that the first assembler END card requires an — ‘a : 


BTRAN requires no parameters for assembling the program, 


1% 


6, . Remove and discard the first card of the first object deck, 


This job stream is aStaloging ihe following spool macros into the DOS . | 
7. Two decisions must be made at this time: 


source library: 


| | a, Which foreground partition will be used for execution of the spool 
MACRO NAME O. OF BLOCKS _ NO, OF 2311TRACKS 
Se 7 system? If two batches will be controlled by the spool system, 
. DSKIO 12 i : as 
oer _ eS then Fl must be used for the spool program, Otherwise, either 
7 12990 81 , 7 | 
| b. POWER ; 3 _. Flor F2 may be used. 
* , 5 P ‘ l z ; 
-c, BTRAN . | eproneg ny war , Ob How much core is required for the foreground spool partition? 
1316 3 83 A 2 

: a | - ae The MNOTE CORE SIZE EVALUATION LABELS which appears 


isk space required for storage of these macros may suggest 
A review of disk sp q ee - with the assembly of the spool program makes referencen to two 


‘pri urce library. If this is the-case, an ee 7 | 
a a a . | , labels: (1) PROGEND; (2) HOWBIG. Core of the spool partition 


| for SYSSLB should be included in the job stfam. 
Sheren ine es is . 18 allocated in the following manner: 


'- 4, Review the macro parameters for assembling the spool macro POWER. 

‘5. Assemble the POWER and BTRAN spool macros. An exemple of the macro | | | - | | register save area =x'78! 

scales and the job stream is: 7 | 2 | : - "A = , 
//: JOB ASSEMBLE SPOOL PROGRAM + . & 


@ 


// OPTION DECK,LIST ° _ Se | ee | ROOT (always in core) 


// EXEC ASSEMBLY . - oe 
i , . PROGEND=+9 


' POWER TAPE: YES, RDRCLOS=EXIT {minimum of 4 DBLK buffers 


) 


on a 


pd two gle 


| ee / END INIT 7 , fa? 4, | 
We Me a, ae aa oo || HOWBIG—33 
. : oO pk ° ’ it ; : i 
// EXEC ASSEMBLY. | a Oo 
‘ BIRAN ; ; es , : ; ‘ . ; L es . tecy ; . 


12. 


11. 


Hence, the size of the foreground partition is one of two values: © 


i) HOWBIG eS es 


ee 


ar . . : y ‘ ' 
aa ' : : 
‘ ‘ : ‘ . 7 . t 
. . : . eth . 
: i : 2 . bs 
. . oy P ; : ‘ 
. ' * . 
‘ ae $ 
Pa . : . . 4 
, % iM j ‘ 
4 
. ® es 
. i : =. * 
= R . 5 
. . 
. 
. e 


‘ 
‘ . 
| 


t 
i 


i 
} 
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. ii) HOWBIG plus the additional number of buffers over 4 which will 


.“be used by the spool system. Note that the spool macro parameter 


9. Ifthe decision has been made to permanently allocate one or more disk 


packs for spool usage; then you may want to initiate the spool system - 


é 


: 3 
bay 


at this time to format the disk packs (see spool initiation section)— . 


es eneul normally indicate how aneny Beitcee es total will” * oe ieee: a a oe ae if eres 
be aged by the spool ayaten, : oe _ 
8.. Catalog the object deck ‘nts the pos oie image library with the following | 
job ateeane - | | 7 - | | ms 
. “ALLOC Fl=nk, F2=mk : | ree above no. 7 for m and n)_ | 
Tw JOB CATALOG SPOOL SYSTEM | . typ He 7 aK | : : ee yg Gee SN a : a Be.s 3 
// OPTION CATAL — | — | | : 3 oh Shee | 
| ACTION (Fl - F2) ) (eee er ae 7 for Fl ct F2) 7 i 3 | a | ee 7 i ae | 
INCLUDE | | : 
object decks | , 
ig os 
: | | 7 . | , oe 
// EXEC LNKEDT | 4 
' | if VII of DOS ‘is eed: then the PHASE card for i phase FGPSPOOL s wall. | | 
must be changed to rehectihe starting address for the spool program, - 2 oe ae a | ; ne . ‘ ; : 
This phaee card is approximately one third of the way into oe object deck, . : | 
; : 


Coens ae 


’ as 


. ™ 


1, F2= 
cae 


TAPE = 
z : YES 


READER = 


. SIZE: 
' Wes 


TYPE 1 


TYPE 2 
BOTH 
NO 


NUMDDKS 6) : 
a ee . n 


(not including the QFILE) 


Power Macro.Parameters 


- Specify ifa second batch will be run under 


control of spooling. “ -* | ae 


. Specify if-tape writers maybe used. 


' % : oe : : ca 
Specify what reader device type will be used 


for spooling; when TYPE} is specified , only 


Pa 
7 a 


2540's and 2501's may be used for spool readers; 


when TYPE2 is specified, only 1442's and/or 


2520's may be used for spool readers; when 
BOTHI is specified, any card reader may be 


used for spool readers; when NO is specified 


‘reader capability is nor available. 


: Specify the maximum number of all active 


readers and writers (|{N4€26) -_ 
. Specify if the spool program is expected to 


ran in a partition which is greater than 12K. 


| Specify the number of physical disk modules 


_ available for spool's data storage. 


Specify the type of disk device used for spool, 


Specify the size of the disk records used for 


storage of the job status information, 


n > 120+ab where, 


= 2ifno readers, a= 3 if readers 7 


Res 
. 


10. 
ih. 
12. 


13. 


16. STDCARD = {220 
: Sat se F y) 


DBLK = {829 
. . ; = 


DNRPERT = 


TRACKGP { 0} 


MAXJOBS = 


18 STDLINE = {ices 


of 


warning message occurs. 


n 


on 


.. QNRPERT = {2} 
‘ ; . n : 


14, SVCCODE = {222 
s nh 


4A 


b = size of the cylinder u. (see . 


appendix A) 


Specify the number of QBLKs per disk track. 


Specify the size of the disk records used for 


storage of card and print images; (n% 829) 
Specify the number of DBLKs per disk track. 


, 


Specify the number of tracks to be used for 
allocation of a track group (see appendix B}. 


Specify the maximum number of allowable 


jobs within spool; n €QBLK-1~-32*a where, 


a=zl if F2 = NO 
az2 F2 = YES 
n%256 


i 
! 


Specify a svc code which must be used for the | 


‘spool partition; n must not be used by DOS or 


by any other special program suchas cs 30, 
cs 40. VIII of DOS uses svc OPsve 34. 


Specify the standard number of generated lines 


which a batch partition may create before a 


Specify the standard number of generated cards 


which a batch partition may create before a 


warning message occurs. 


16. 


17. 


19. 


20. 


21. 


ADDITR = C ooo 
n 


- AUTOSTR = 


‘to generate béfore another warning message occurs. 


Specify the number of additional print/punch — » § 22. RDRCLOS =( PAUSE| Specify what action a reader should take whenever 
| fee 4 GO 
EXIT |the end of file and the end of job is encountered: 


eetoets which will be serelied by the batch 


PAUSE requires an operator message to reactivate 


00c Specify the device address of a reader/printer the reader; GO will cause a standard DOS I/O 
non , : . “og t « EXIT 
NO ) writer which will be automatically started at intervention required message to occur; a 
spool initiation time: nnn should be a card | ae _— > will cause the reader to permancntey BSOEs hee «| 
reader device address if readers are used; releasing all allocated buffers. |. . ‘ 
otherwise nnn should be a printer device address: ; = ” A MAXBUFS = {3} ‘Specify the maximum number of buffers ieee We i fey ity 
‘ : .- Ot} , eT Oe a 
, , . ‘ : ‘ : ‘ / d 
NO indicates that no reader/writer will be will me allocated for rhe Bpooh use (n ® 4). | 
7 automatically started at spool initiation time. . a ig : INSCRIB = oo ts 3) Specify if spooling capability will be generated 
MAXCCB =} 3 -Specify the number of active unit record and tape | Ve atin ' for the magnefic nscEIves YEE 20 
n ; . ee = i : : . * $ 
devices which the spool system may be simu!taneously [ 25- RIE1050 = Specify if remote job readers and writers will 
| :  RYIE2Z780 = (NO). a 
‘ using. (see apendix C) | . 7 -  RJE2740 = YES |' be generated for the associated devices. 
=? a | es RIECPU = \ . 
RDREOF = GO Specify what action a reader should take whenever | . | : 
> = PAUSE . x ‘ 
ye end of file but not end of job is encountered: i i RS 
| ie) aes 
ag requires an operator. message to reactivate ¢ atte * 7 
the cevace: GO will cause a standard DOS 1c | 
i =}; : | Arte i i “3 
: 4 é. (PLA AE - . r) 
intervention pequined message to occur. f 3 f9! oe wn 0 Hf Ly LO x Vy. 22, 
ACCOUNT =} NO ( Specify ifa user accounting routine is to be 
—_——— 
assembled with the spool program; xxxxx is 
the name of the user's accounting gi a et : | 1 ae os " 
y ne g ee ¢ Ro Le v4 han u ‘. é, f t - “) nn eo : | | | | | ‘ . . ind . ce 
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Cylinder bit table - used for dasd space management 
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C. Spool's- logical symbolic i/o assignments 


| SYSO01_ ~ disk device - QFILE reference 
H (b) bytes long SYS002) - disk device - DATAFIL reference - first module 
a SYS003 a second 
: : a oe SYS00m - | last module 
Each bit represents 1 track group (see appendix B) | - | 
Bee ee x 7 SYS0Om+1.— os tape/unit record device #1 - dynamically assigned 
i. if TRACKGP; 5, then (200 cyls*10/5)/8 = 50 bytes. = b S¥SO0m+2 + : #2 
ii. 10, then (200 cyls*10/10)/8 = 25 bytes = b SYSO0n 2s last 
2314 | 6 et ae, a ee Hence, the supervisor which will be used with the spool system, 
i. 5, (200 cyls*20/5)/8 = 190 bytes = b- fe 
fa 2 ee 8 a, BPE SA ee must have n+] problem program lubs generated tor the appropriate fore- 
ii, 10, (200 cyls*20/10)/8 = 50 we | 
os ee ee ae ground partition, © 
iii, 20, . (200 cyls*20/20)/8 = 25 _ oo, 
. a eee ae Example: 
“Track group - used for dasd space management 1 data disk 
, i : : ; ; : es . a a . : 
A track group is defined as the number of continuous, tracks _ 3 unit record/tape devices eo @ Sate ee 
allocated per request-to a spool task, whenever, a spool task requires SYSO001 = = QFILE' reference 
' disk space. For 2311's, a track graup can be 1,2,5, or 10 tracks, while for ee S¥S002 = DATAFIL reference re 
2314's atrack group can be 1,2,4,5,10, or 20 tracks. ar SYS003 = - 
- SYS004 8 unit record/tape device assignments sua a 
*- . SYSO05, = 


lH 


TOTAL problem program lubs = 6. 


i 


a 
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SPOOL INITIATION 


% 
Assuming SPI soae at initiation ofa l data disk foreground spool program, | 


then the following cards should be prepared: 


i 
t 
' 


t 
} 
et 


cy ALLOC Fl=nk, F2=mk | ; (see part 7 of spool sysyen) 


i . 
~... \ ASSGN SYSLST,UA - 
‘ } es { 


, : 
7% / , : i 
RN a, ay, * ‘ : 


ASSGN SYSIN, UA. 


ASSGN SYS001, X'cuu! QFILE disk 
: _ASSGN S¥S002, X'cuu! an od | DATAFIL disk 
it DLBL QFILE, 'any alpha characters’, 99/360, DA: 
// EXTENT SYS001,vol serial no.,1,0,rel track, no, of tracks 
f/f DLBL DATAFIL, ‘any alpha characters!, 99/360,DA | 
. // EXTENT eerouos ial serial no.,1,0, rel poetic no. of tracks | 
eee 7 exec FGPSPOOL 
* $$JOB 
* $$PRTD 


Required for writer only system 


_* $$PUND 


,\._ ASSGN SYSLST, X'énu' 


| The QFILE and DATAFIL need not Se: on the same physical pack, Choice of 


the number of tracks for the DATAFIL is based on how much of the pack has 


_ been allocated for sacl usage. Choice of the number of tracka for the OFILE 


is based on the QNRPERT and MAXJOBS parameters. Appropriate DOS VI 


label control cards may also be used if necessary. - 
a1. 


A printer carriage. control tape must be created without a channel 9 punch 


and without a channel 12 punch, 


¢. ‘READ X'cuu' 


If this tape is not placed on the printer, an 


- uncontrolled occurrence of print line dropping may happen. 


Place the indicated control cards in the card reader and execute the job stream, 


f 


When PLEASE ASSIGN SYSRDR appears on the typewriter, enter the following 
DOS commands: 


a. STOP 


| wnonrcerasecenns=-Hit typewriter request key 


READY FOR COMMUNICATIONS - ---- generated by DOS 


b. ° START (Fl or F2)_ 


i 
= 


per eereeen ere ~---At this time, the foreground control 


1 


pe 


rer 74 2 errs are read, 


ENTER ‘COLD! ‘OR’ ee OR 'CLRx'! ie --- generated by the spool 


program 
i es 
WARM én 
-CLRI . 7 q : on — 
. One of these should be entered. 
CLR2 . 
CLR3 
: i. COLD : gered whenever ie aate on the spbet files is 
needed, Spool packs should, however, have been - 
formated neat a previous spool initiation. | 
ii. WARM ~ entered whenever data on the spool files is needed. 


This option ghould normally be used even if the spool 


@ files are empty of work. Spool packs should have been ° 
formated from a previous initiation. 
iii, CLR1 --QFILE only 
"  - 2- DATAFIL only 
3 - BOTH files a : 
entered whenever the spool packs have never been 
used for spool operations, Normally, this opticn : 


is only used once at sysgen time, unless the SEool- 


disk area is used for other work. 


: ne . i] 
If AUTOSTR has been generated into the system,then the followingvappear on the 


_ & 


typewriter; - 
4 
ROOC 
BG BUFFERS = _ | . 


TOOE 


Refer to the operator commands for this message. If AUTOSTR has not 
been sepaaed into the system, then appropriate readers and/or writers should | 
be started at this time, - When all spool readers and/or writers have been 
initiated regardless of the AUTOSTR option, continue to enter the following 
DOS commands: - ~° es 
- pomtolusewee steciwecws hit the typewriter request key 
READY FOR COMMUNICATIONS ---~ generated by DOS 
e. START | : 
f, ASSGN SYSIN, X'cuu! 
e 
g- oOo 
i . aaa 
pos is now completely des control of the spool systemy | 


23. 


\Aa 


OPERATOR COMMANDS 


© 


All spool typewriter messages are preceeded by some task indentifying characters 
(prefix) The following three different types of spool tasks can issue messages oY 
accept input data: 


1. Operator command task ($OP prefix) 


This task is activated by depressing the console interrupt key. The 
characters $0P will be typed andthe typewriter will be waiting for 

operator input of a command. Note that the use of the console interrupt 

key for spool seaee does not conflict with the background's usage of the 

Key. Depressing the console interrupt key a second time wh.le the type- 
writer is waiting for input, will allow the background to use ita console | 
interrupt routine: If all activity on the cpu is dormant, then the operator 
must depress the console interrupt key a second time in order to activate 
the operator <sanana task, This action will cause the message NO 
ROUTINE LINKAGE to be typed prior to the appearance of the $OP message. 
‘Reader/Writer task - {prefix-see text) . 
This task is activated by entering the S (START) command, Refer to each 


message to find out whether the reader or writer task deactivates itself 


after typing the message. The typewriter prefix for the task is: 


fone eo. ee 
XX - BG or F2_ 

Y - T(printer writer) » P(punch writer), Qr R (reader) 
222 - unit record device address used by the reader or writer 


a 
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"3. Batch perce task - ($BG 0 or . $F2 prefix) 


This task is active whenever DOS activates its BG (back. round) 


| 


or F2 (foreground) partitions. ms, . dan 


The brackets, which appear with the description of the following commands and 
messages nereste that the parameters, within the brackets are optional, The 
brackets { } indicate a choice of required patarmeters: Small letters indicate 


ants to be entered by the operator while capital letters indicate data which is ea 


by one of the three types of spool tasks. 


OPERATOR COMMANDS 
Entered when the console interrupt key is depressed and the prefix 
$OP appears on the typewriter. 


A. Start a reader or writer 


_ BRKYYY, 22% ne 


| prt). i 
» op YES C Peay: : 


rdr : 


zzz= unit record device address | 
‘ 
aaa= tape drive device address- to be used to start a tape writer 


example: | | | | | 

a. s bgprt, 00e | . ~ a 
b. #8 f2pun, odd, 180 : | . | 
This command is ueed to activate reader programs whieh will read 

cards and create job queues to be processed by batch partitions; this oe 


command is also used to activate writer programs, print or punch, which 


will process print or punch queues that have been created ey the batch partitions. 
25. : 


Stop a reader cr writer 


Pp XXYYY, ZZZ 
(bg : ‘ prt aon a ee ee 
ae! — -WyYy=¢ pun a ZZZ= unit record device address 
: rar ee ee 
example: 
a. p bgprt, 00e | Sc | _ “a 


b. p f2rdr, ooc 


This command is used to deactivate a reader or a writer program. All core 


buffer space used for all associated disk/tape 1/O buffers and core buffer 


} 


_ space used for the reader or writer program itself is released for othercuse! pe 


if phos program is currently preparing a job to be run by the batch Sarticon: a 
the ees oh 


thengstop command will cause the reader to terminate the eard reading. The 


€ 


_job must be re-entered through another activated reader. Ifa tape/disk 


° 


writer is currently printing or punching a job, then the stop command will 
cause ane writer to Henin te the printing or punching. The job is not deleted and 
it can be re-processed Gucnesas another aie is activated, Note that in 
the case of a tape writer, the tape is repositioned to the beginning of the 
current job. i. 
Cancel a reader or writer 
Cc xxyvy, Z2Zz | 
frst Be Siee ( prt) 
a Ves | yyy= Pan | 


Z2Z= unit record device address 
rar ; 


. example: 


a: <c bgpun, coed 


b. c f2prt, oof . | 5. 


This command is identical to the stop 'p' command for a reader program. 
20, SS a ee ee 


“4 
' ‘ ‘ : . , - - eo 
tec < g : é : 4 


In the c the tape or disk writer, however, the cancel command deletes 
. the curr b being processed by the writer prior to de-activating the writer. | 


* 


~ 


AAAAAAAA BBBBB PH CCCCCCC © a © oN, 


where, 


‘ 


os AAAAAAAAS job name 
D. . Restart a printer writer . 


| .BBBB= job number 
 t xxprt, zzz | | : sf : . 2 
bet —_ ' gzze unit record device address _ _ "aa ¢ _ P= priority no. ( if any) 


xx-¥2 . 
. 


, example: H= the character H if the job is in the hold status 


a. -  t | bgeprt,ooe : CCCCCCC= number of logical beeavde in this job's file. 
 * —t f2prtoof | | me = ot r Hiepecibeso Jona Toube aiayyy: then the message QI8 EMPTY 
This command directs the associated sities writer to discontinue printing B will be typed. If the JOB OPTION is requested and no job aaaaaaaa 
at its current disk/tape block; the printer writer immediately resumes | - [, bbbbb] can Be found, ‘then the 'D' ee isemiasies without any 
7 printing at the beginning of the jobs printed Suene. | | ,e _ cenit. All jobs for the appropriate OPTION will be displayed before ie | 
7 E. Display Sea | | | | - ; - 7 | 5 ag eunnmead is complete. Note that any spool janes which need the job Suche | 
| d xxyy, aaaaaaaa [, bbbbb] . JOB OPTION . = : - fie will wait until the'D' ened nas terminated. | = 
d'xxyyy, all | | ALL OPTION "BY Hold Command | a 
d xxyyy, hold : | | ° | HOLD OPTION | | _h xxyyy, aaaaaaaa [, bbbbb] | _ JOB OPTION = i. - ok ‘ 
" d xxyyy, pn a "PRIORITY OPTION | heyyy, alll ot  opTION: . ae 
bg ve + ot es a | | | - bel " og prt - 
KE f2 —oyyys(prtfo oo” aaaaaaaa= job name ~ 7 : | =e ‘xx=) £2 —OYYY=¢ pun) © aaaaaaaa= job name 
pun po es — — ae | “ae 24 rdryje ee Se ol 
rdr . | bbbb= job number - : _. we . a - Ge bbbbb= job ee 
example: -_ a a | ; et ee ys og * . example: | | | | ; 
a. d bgrdr, jobabede, 09021 , : mi a 2 | - ; oe - ae a h berdr, jsbabede econ | | Ae ee =; — 
b. d {2prt, all ae 7 — 7 7 oar - | _ ns Sar f2prt, all | 
rae d bgpun, hold oe 7 ee ie | = | | | | | | 7 ; - : This Sepmaanis used te eeeent the processing of one or more jobs in the 
ar a: ‘d (2rdr, pl | . ; a ‘ a | - — « ae - | . : | specified queue (yyy}.- Such jobs will he held waiting until the operator 
This command tsGaed to display the atatae-Bt one or nuee jobs in the frees them with the 'R' command, In the avert the pesaee eieua: all 1 | 
ssecitiea queue ear The format of the statia which aséaies _ SYSLOG | 7 ieee will net be processed by the batch partitions. In the case of cNé 
IS: | = | | . | : veer queues, all I jobs will nat be printed or punched, If there are no 


} 
i 
! 


. jobs in the queue (yyy), then the message Q IS EMPTY is: typed. Review the 


A 


'R'- command to see how to implement ope 


4 


rator oriented job priorities. 


. G. Release Command | i. 
7 r xxyyy, aaaaaagaa[, bbbbb] , | JOB OPTION 
: | aa 
r xxyyy,all | : ALL OPTION 
>“, _ be _ (prt : 7 ae a 
. “oft yyy= 4 pun aaaaaaaa=job name | 
ped ‘\rdr | a ~ 
| .. | +. bbbbb=job number 
on: ecatnnies | - 
ks a r bgrdr, jobabede, 00011, : 7 | 
“b.or fprt,all | : | | 
This command is used to free, for processing, one oe more jobs in the 
specified queue (yyy). In the case of the reader» queue, all 'R' jobs will | 
Becbine immediately available for processing by the batch partitions. In 
the case of the writer queues, all 'R' jobs will become immediately available 
for Hrinting or punching. by all active writers. if there are no jobs on the 
‘queue (yyy), then the message Q IS EMPTY is typed. Any specific ,ob . | 
. ‘aanaaaaa[, bbbbb] can effectively be placed at the beginning of its queue (yyy) Ss. 
: by holding 'H' all jobs of that queue and selectively releasing the important _ 
job aaaaaaaa[,bbbbb]. Hence, the next job to be processed in queue (yyy) will” 
be the job aaaaaaaa[,bbbbb]. This method of implementing operator jod 
priorities dees not stop or ‘cancel the current job of the queue (yyy).. The 
DOS opereior command “CANCEL" or the spool commands 'P','C','F'! 
should be reviewed to be able to manipulate the current job, 


Fiush Command 


f xxyyy, zzz _ CURRENT JOB OPTION 


f{ xxyyy, zzz, all ALL JOBS OPTION 


“Y 
(bg — 
mcf (2 3 ¥VY= at  ., 22z= unit record device address 


| pun 
example: 


a. f bgprt, ooe 
b,  f £2pun, ood, all ~ ae ge end Cee 


This output writer command deletes the current or: ALL jobs from. the queue 


(yyy) with which the writer zzz is associated, The writer remains active and it 


will continue to process any free jobs in the queue (yyy). ‘If more than 


ene writer is active with the queue (yyy), then all active jobs associated | 
a i i 


+ : 
with those writers will:not be affected by the 'F' command. 


Go Command : 


< 


g xx fe = BATCH OPTION 
Bxyyy, zzz Ft, READER/WRITER OPTION. 
bg ma rt . 
xx=(f 2 ; yyy=4punb zzz= unit record device address °° 
- rdr}- , 
example: ri 
a. gbg 7s oe 


. ' 
. . 


b. g f2prt, coe ie ra 


This command is used ta re-activate a spool task which is waiting for 


"an operator response, The BATCH OPTION is normally used in 


. response to error or warning messages while the READER/WRITER OPTION 


is normally used in response to informative messages. 
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SPOOL CONTROL CARDS | 


: @ 


. we | Delete and i i - | . ‘ <, ; | & | ne 
, 4 XXYYYs sadazaaal, bovbo| | JOB OPTION PO 
. : 2. In a writer-only Sspocl environment, spool control cards are mandatory 
xxyyy, all | “ALL OPTION | a oe ses OS yes A 
bg 7 prt for every spool job. However, spool cards can be optionally defaulted to the DOS 
xx=){2 yyy=fpun } aaaaaaaa= job name | ccutee - 2  . GBs 
| | rdr //.JOB and the /& cards whenever readers are generated into the spool system, In 
bbbbb= job number ; | . . ; ; ip 9 
. | this case, jobs defined through spool control cards can be interpersed with 
example: a tere , i e hes eho® 
defaulted spool jobs. Following are the four fixed format spool control cards: 
a. } bgrdr, jobabcde, 00011 (note that there is a blank column between the * and the first $) 
a * $$JOB (nnnnannn] [,p] [,h]} 
b. J s2prt, al | | . i 
. sa | ee eG ie _ , ao nnnnnnnn - alphanumeric job name 
This queue processor command deletes one or ALL jobs from the queue (yyy). 7 | 
| | ‘ ; p - priority number 
Ali jobs that are currently being processed by readereor writers for the Pike ; is 
ae @ a é : 7 x H - enter directly into the hold queue 
f "queue are not affected by this command. In addition, jobs that have 32% 3 7 ee es - 
ae my Ms | - : ; b. * $$PRT { t [, 22x] wa , mmmmmm ] [, rrrrrr] (, wauuvuuy] 
been held will not be affected by this command. If there are no jobs in ey '¥ | 
' the queue then the messa IS EMPTY is typed. | " 
: we Me at a | D - spool out ot disk 
K. End Spool Command | | | ; ae ae a ms th . i a ee 3 
: : . te T - spool out to tape 
oe Re -_ — i SG PE a hs | | | “23 ae ae N = do not intercept print requests 
3 rae 2 ‘ e ‘ ; 1 . 
This command is used to normally terminate the spool partition and to. ee en ee | 
os . . ; xxxx - forms number 
restore the system to normal DOS operation. : i | ne 
a yy ~ number of copies 
L. Kill Spool C d | | 7 : ae a ae er ee : | Z es 
oo | — ' 2 e .% | | yyy - device address of tape drive 
‘ _k 4 ; ry, - ; ) . 
This command terminates the spool partition with a dump. SOTA eRe eer number of lines before 
~M. Nop Command 
voc NS ee oF warning 
n : rrrrrrvp- checkpoint gounter ducing listing 
This command is used to free the typewriter which is waiting for an Se a | es |, MERVYN: UCS buffer load phase name 
operator response toa $OP message. No action is taken in response to the 
'N' command. *. 
, - ba 


ere 


66% $$PUN d A 


* . 


d.% $$EOF- 


end of 8s 


al 


_ 
y 

I 

i 

i 

t 


IE ae xererz| : 


‘- spool out to disk 


MAXX 


5 


T 7 spool out to tape 


N - do not intercept punch requests 
roccx = card number 
yy - number of copies 
-- Vyy . device address of tape drive 
-mmmmmm ‘maximum number of records 


|, before warning 


rrrrrr - checkpoint counter during punching 


pool card | 


The placement of the spool control cards and the DOS control cards is as follows: 


“2a. kSSTOB 


b. ¥*$$PRT 


4$$PUN | 


c. // JOB 
ete 
/& 

// JOB 
etc 


/& 


d. *$$EOJ . 


If defaulted DOS, 


- must be first : 
} oo = must be second and third if present © 
etc 


| . normal DOS job(s) or a portion of a DOS job 
etc. ct ; . 


must be last. 


control cards are used in place of spool control cards, then the 


ad ; 


following defaulted spool parameters are used: 


i. nnnnnnnn ~ job name - taken from // JOB nnnnnna 
hi. : no priority ‘ 


. iii, no held © 


‘4. D- disk 
ii. blank - blank forms number | 


iii. - 01 -‘l copy 


- STDLINE 
". vy. STDLINE - checkpoint counter - same aa STDLINE 
vi. blank - bhank UCS phase name. 
i, -D-~ disk 
ii.. blank - blank card number “‘ 


-iii, O01 - 1 copy 


STDLINE - maximum number of lines = system generation parameter 


iv. STDCARD - maximum number of cards = system generation parameter 


v. STDCARD - checkpoint counter = STDCARD 


d. EOI 


STDCARD | 


occurs whenever a /& card or another // JOB card is encountered. 


9 » 


destruction is appropriate with the review of spool control cards. 


Some discussion relative to disaster restart, machine check, or operator job 


Three critical 


points in a job's flow through the system must be evaluated to understand 'WARM'! 


restart: | | 34. 


a. ‘@ END OF JOB TIME - (applies to reader spool system) 
occurs whenever the reader encountered a *$$EOJ, /&, or // JOB’ 
: : ie 4 _ ‘ ; : * | » 
: - card. If an unrecoverable error occurs prior to this time,’ the job 


" currently being read by the reader must be entirely re-entered, 


Following this time, the job just read will remain in the spool 
- system until the job has completed execution. 


! 


b. EXECUTION END OF JOB.TIME - 
occurs whenever the batch partition has processed the spool end of 


. 
' 


job record. If an unrecoverable error occurs prior to this time, 
‘the job fie ecay in execution must be entirely re-run. However, 
"the job dees tot have to be re-read by the reader portion of the spool. 
When execution end of job time is reached, all information regarding 

printing and/or oanehing is saved fox restart purposes. Hence: 

following this time, the job just executed devs not haves be ocean: 
¢, WRITER END OF JOB TIME - | 

. occurs eneneeee the writer outputs the last line of print/card. If an - 
. unrecoverable error eee pelertc ‘hinstune: the job egevendy 
being printed sepunched must be entirely Pécuiated be repunched, 


Implementation of the checkpoint parameter in the *$$PRT or 


*$$PUN would reduce the reprinting or repunching time. 


“ 


enna open et 


+ 


ERROR AND INFORMATIONAL MESSAGES | at 


+ “$OP INCORRECT OP COMMAND 


Incorrect format of the operater command was entered. 


: ACTION: er . 4 oo | | Oo roa 
'B. ” $O0P NO ROOM FOR PROG XXY on i 
BG . a AT]. - print . 
xx-|F2 $ . . | Y=3+P punch 
. R reader 
No buffers are available for storage of the reader or writer p 
the operator is trying to 'S' (START), . : a 
ACTION: Cancel or stop another reader or writer; or wait unti 
| savririva becomes inactive, | | 
$0P ALL SPOL LOCS ACTIVE 
The operator is attempting to activate more reader or writer scGacain 
than were. declared at spool zysgen time. 
ACTION: Cancel ae siapiansthey reader or writer; or spool sysgen again 
, declaring a larger number for the MAW RW parameter. 7 
D. $OP ¥Y¥Y ALREADY IN USE | 
we unit record device address a = eer es ee ee ae 
The unit record device address YYY is currently being used by another 
reader or writer program. 
ACTION: Check that YYY is the correct device to be used; dabeet or stop the 
reader or writer using ue device if you want to use the device YYY. 
E. $XX. | 


DDD HAS NO PUB/BAD D 
AXYZZZ | 
DDD is net a vaiid device address for thia DOS supervisor; or DDD is 


not a valid device type for this reader or writer functionji. e. starting a punch 


writer to coe where oce isa device address for a printer. 


$XX ALL CCBS IN USE 
XXYZZ se 

The ‘operator is attempting to activate more reader ‘or weiter programs and 
he is using more tape spool facilities than were declared at spool syszen 
time. 
ACTION: Cancel or stop another reader or writer; or spool sysgen again 


declaring a larger number for the MAXCCB parameter. 


G. XXYZZZNO BUFFERS 


No buffers are available for use as a disk/tape I/O area. This reader or 


writer is automatically stopped. 


_ ACTION: Cancel or stop another reader or writer; or wait until a batch becomes 
e 


inactive. 
H. XXYZZZ BUFFERS =jab 


This message occurs when ‘the reader or writer is initially Stanted: The 


+ 


Operator must respond with one character’a' (reader or printer writer) 


or with two characters tab! (punch writer) weeds, 
1 : | ‘ 
az=j2 indicating 1 or 2 disk tae I/O areas for use with the 


reader or writer program, If any character other than a2 . 


is entered, 1° buffer will be used. 


o 
Vv 
Nm = © 


ie a pause code for disposition of punched output. oo. 
Pause occurs at ane beginning of the job. | | 
0 or any oe do not type card id unless a. Bere in id occurs 
l= type card id for every job 

2= type card id for cen oo job seieas a change in - occurs | 
Mt ‘his message occurs a second ime a second buffer was not avallabte tor 


" use with the a option. A response oft 1’ must be entered with this message. 


at: 


| 


$OP NO BUFFERS AVAIL 


This message occurs with the 'L! eee when no I/O buffers can be obtained | 

for disk I/O operation. | 

ACTION: Retry the 1b command whenever a reader/writer or batch has ter-~- 

miniated | | 

$OP RDR/WTR ID-NO MATCH 

No reader or writer with the identification characters supplied in ine. eanaea 

can be found to be active. 

ACTION: Verify spelling. ae again. 

XXY222 AAAAAAAA FFFF. FORMS NEEDED 
AAAAAAAA= job eae | | 


FFFF= form/card id 


| This message occurs when a change in forms or card number is encountered mE 


a disk print or eunen writer; it also occurs for.a punch writer which has been 


, Started with-a pause code of 1 or 2. 


ACTION: Change forms or cards. Respond with the operator command g xxyyy, zzz 
XXYZZZ JOB NNNG FERFF F FORMS NEEDED eh : , 
NNNN= ae? count id on tape, ie 
first job on tape NNNN-90 k, third job on tape NNNN=0003 
FFFF= forms id 


This tape print or punch writer message is identical to the disk print or punch 


writer message except for the job identification field. ° 


' XXRZ2ZZ EOF. _ © ge te oe Oe 


This input*reader message occurs when end of file is encountered on the 

card.,reader prior to reading an end of job card. 

ACTION: The Sysgen parameter RDREOF reflects if the operator must respond 
° 


with the g xxrdr, zzz co a. j | 
? ; c mmand. In either case, ready.the card reader 


oe wi -msinin portion of the job stream.. 


N, XXRZZZ CLOSED _ 
, . | ; ; 
This input reader message occurs when the end of job and the end of 7 _ 
'. file is reached on the card reader. The input reader remains 7 _ ; ‘ 
in core with all buffers still allocated to it unless the RDRCLOS=EXIT option 
_ was taken at spool sysgen time. © | : 
- - ACTION: The sysgen parameter RDRCLOS reflects if the operator must 
respond with the g xxrdr, zzz command. In either case, ready the card. 
a reader with new jobs when they have been received; or, stop or cancel 
the reader with the 'P', ‘Cc! cemmand prior to issuing the g xxrdr, zzz 
oy _ ‘commands | This will free up the core allocated to the reader for use 
ce a - by other spool functions. —. - | 
‘OQ. * XXYZZZ ENDED | | . 


~ 


This tape writer message occurs when all jobs on the tape have been printed © 
or punched. - The output writer frees. up all core allocated to itself. 
| ACTION: None, ‘unless you want to start another writer, 
-.P..§$xx (DATA DISKS(S) FILLED _ 7 _ 
XXRZZZ)_ | | os 
This message occurs whenever all cylinders of all data disk(s} have been 
reserved. | 
ACTION: i. Wait until an output writer frees up some space. 


ii. Or, start an output writer to free up some space 
, xX 


iii. When some space has been freed, respond with the {yeah 


command to continue. You may want to cancel the batch or cancel. 


or stop the reader if you know that it will continue to fill up the ~*. 


disk. 39, 


‘at 


I i a a a eM ge a 


'. ACTION: 


OR. 


© 7 


This batch warning message occurs during execution wheneyer the 


MAXIMUM RECORDS EXCEEDED 


maximum number of records for the outputting of print or punch 


records has been exceeded.. 


An installation decision. To continue, respond with g xx . 
to permit outputting a standard number of additional | 


records before another warning message occurs. Ta 


cancel the job, enter the standard DOS operator cancel 


. 


$XX 


command prior to entering the g xx spool command. : 
feces “NO JOB Q SPACE 


'  The$XX form only occurs whenever input readers are not used for 


. spool operations. This message occurs whenever there are more. 


. jobs in the.system then permitted by the spool sysgen parameter | | 


- Ss. 


. encountered by the associated task. Ifa reader or writer encountered 


MAXJOBS. , 
ACTION: +' i. ‘Wait until an outpugf writer completes a job. 7 os 
, . 4 . 

ii.. Or, spool sysgen again redefining the MAXJOBS parameter 


XXRZZZ READER DISASTER, 


“XAXATZZZ° PRINTER DISASTER. 

XXPZZZ PUNCH DISASTER .. 
$XX es | 

XXYZZZ ‘DISK ERROR 


$XX TAPE ERROR 
XXYZZZ _ x 


a 


These messages occur whenever an unrecoverable I/O error has been 


Y 


the 1/O error while it wasn't processing the Q DISK file, then the 


_reader or writer frees up all allocated core and terminates itself.. 


In the case of writers, the current job is not delcted from its appropriate 


40. 


ary e we : , . : . ‘ 
. queWe. In all other encounters of I/O errors, the spool partition . . 


MODIFYING/ CHANGING POWER 
terminates with a dump, and it restores the cputo normal DOS _ = Following is a list, with comments, of potential areas of sivezation to 
operations. a _ ye . oe” ee - the spool system: 
| a. | Accounting Routine 
The job control table (JCT) currently contains statistics on 
‘ number of cards read, number of lines printed, and number 
. 7 tS Ey Bc Be oe fe ab | “a : . a. of cards punched. Fields for time, JCTRDRT, JCTPRTT, — 
| i. ee : we | i se . - 7 i JCTPUNT, JCTEXECT, have been r@served for user 
. ae bts ae, er - — pat at a im ; a. * — processing. Code would have to be added to ae reader, 
| a ae at ae 2 ae a | | - writer, begin job ae processor, and end of job processor 
| to obtain time figures. In addition the macro to be used with 
ce : | ae ee, Sus 7 har _ gi. 2 = eS : 7 . 4 3 the ACCOUNT spool sysgen must be written to be included 
Poe with the purge phase (FGPSPOL9). 2s _ ; 
bos e ‘ 7 oe | oad | : Ob, Special Line Counting Code - (Channel 9 and Channel 12) 
un oe bs alia cae. ag ) ie , : Fe 3, ees | : . Bose. | If the printer carriage control tape support is inadequate, then 
| ee soe ee ee : aee eS ay 7 ' * the following sections of the spool ayetele should be altered: 
a _ - es ka , : _— oe ~ ae LINECONT, ENDPAGE, FULLPAGE must be capable 
Oe ee ee ee a eo oo | "4 Beicingthidpedice Genbesas = =O CC 
| ee Be EE G5 ts ia, * | tk 5 8 rae _*$$PRT cede must hugecode sdded to it to permit one 
Oy ceca a, & os eee ee gf See a | > , or more iine counting. parameters. | 


eS eae ee eee ce ne a | 3. Additional code should be added at the label NOTPRINT to _ 


= ae oo ee 5 A. et ae ys _ sppport channel 9 line counting status. 


4. Channel 9 and agence 12 skipping capability should be 
included at: | , _ 
i. Channel sapendape code to supply CSW status 
ii. Printer writer phase FGPSPOLO to trigger CSW posting 
iii. Printer writer phase FGPSPOLI to reset CSW posting. 
iv. Printer writer phase FGPSPOL3 to test Channel 9 
and/or channel 12 status; reexecute the print eins 
It is expected that channel 9 and channel 12 skipping | 


capabilities will partially degrade performance. 


Job Status Typing 


If it is desirable to make the output writers type end job status, 


_ then the end of job code with phases FGPSPOL1land FGPSPOL6 


should be altered to type any required information. 


' Special Readers/Writers - 


If the conventions of the existing readers and writers are used as 

a guideline for adding any special reader or writer, fee the | 

eff ort of adding the special capability should.not be enormous. 
However, babecte ieuteaae of the internals of the system is 
serene to undertaking the effort. | _ , 
Buffer Size Manipulation ' 

Since some of the reader and writer phaseé require 829 bytes, the 
lower limit of 829 was placed on the DBLK spool be gitia oueanieted 
However, if core utilization is a serious Scabteny, then reducing 


the size of the disk/tape I/O buffers may help. If such is the, 


case, the following sections of the spool system should be altered: 
43, 


= ed 
: m 


beginning of the POWER macro to reflect two types 


Change the macro parameter editing code at the 


of buffers; (1) reader or writer program buffers; 
(such a buffer could be a grouping of I/O buffers) 


(2) disk/tape I/O buffers. 


Alter the code located at the labe} S3 of the FGPTYPSO 


phase to request a program storage buffer or to 
request continuoug I/O buffers. 


If the technique of using a program storage buffer pool 


is used, then code must be added at the labels 


. COREBLKS and LOOPl. — 


4A, 


Nv 


“POINTS TO PONDER | 


5 


used since no check ig made to determine if the printer or punch 


is currently printing or punching. 


If no data disk space is permanently held (dummy job), then 


data disk. 


Although the formatting of the data disk is extremely fast, it is 


recommended that some disk packs be permanently formatted 


for spool usage. 


Placing the hold status to a job currently in progress does not 


! 


\ 


stop that job. 


Any reader or writer will not honor the stop or cancel command 
until all outstanding I/O has been complete (ie. intervention 


required on the reader must be satisfied before p bgrdr, coc 


is taken). — 


Whenever the batch partition executes a print or punch command, 
a spool job re be defined at that time. Otherwise, an error 

' meseage occurs and the line or card is lost. ° 
Spool seek separation is Gaslementeaditn the agaumpiiean that the 
entire disk volume is dedicated to spool. If the QFILE is to share 
the sarne volume as one of the DATAFIL volumes,then SYSOO2 of 
the DATAFIL should be assigned to the same volume as SYSOOL 


SYSRDR and SYSIPT should not be assigned to two different unit 


record card readers. 


45. 


, 


' The N option in the PRT and PUN cards should not be heavily: 


there is no recovery when a single job completely fills the 


1Q. 


1}. 


If an invalid. CCW op code is executed by the problem program, the 
sDCO1) systein forces an invalid logical unit specification. 

When the hold is sewed for a jobin the spool system, then that 
re is carried to all queues in which that job can be found. 


The ATTN OOC message which normally occurred at card reader 


end of file does not occur under spool. 


46, 


‘ ‘ . : : o : % 
uA ‘ Tape Ke 
ie a © Temporary and/or Permanent Restrictions _ Spe ey + 
| . de : _ 4 ae PS ai Sy "This volume contains 1 file and 2 tape marks arranged as follows: 
J. ‘ Tape - No multivolume support ne: ee A Ae | | 
2. . ‘ Column binary card reading is not supported 800 BPI; 9 TRACK 
3... There is no card punch stacker selection for 1442 and 2520 i | , | ue Ti: a 
) ae ca .! 8 7 | | FILE: . Macro Source Records 
4. ' Only 1 data disk is supported ee eo ss to a. | | . EBCDIC © | ie 
| | | Sequenced in cc 79-81. 
5. -: “A TRACKGP must be equal to one cylinder ; : SPOL in ce 74-77 | 7 
 * 7 | oa, 7 _ 3091 81 byte records blocked 40 per-block 
’ 6, ' Checkpoint for printer or punch writer is not implemented. | 78 blocks of 3240 bytes each 
| S45 | . TM: |. = 
t Tape punch writer is not supported © : aoa , | 
| | a See the section on Spool Systems Generation Procedures to deblock the 
Se WB, - UCS automatic loading is not supported. 
' tape, 
9. Priority numbers are not implemented . | 
- | | ; < Sample Program 
_ 10. ' Data buffers must be used for reader or writer program storage 
5 ie No implementation of the partial spool job to start printing or punching . | a The following sample program can be run under spool control to 
~V 12. ‘Extent boundaries for the QFILE and the DATAFIL must be on cylinder | "* list the macros: = | * os 
“boundaries, Magnetic inscriber and RJE aren't implemented. | ane: ff JOB LIST SPOOL MACRO | , 
oo a #33 | Ae ~_ ff, EXEC. SSERV 
DSPLY A. POWER, A. BTRAN,A. DSKIO 
‘of /* 
; 1& ; 
. ° . : 
” } 
ae 46, 
. | ! 
; ! caer : 
Ff % i | 
| | : | . ; 
' “<I | : | - 
- : | aa ! 
eine ) Neh : 


